home *** CD-ROM | disk | FTP | other *** search
/ WOW! 2 / WOW - Vol 2.iso / pd_share / system / megmatic / megmatic.doc < prev    next >
Text File  |  1994-10-17  |  22KB  |  487 lines
  1.  
  2.  
  3.  
  4.                                MEGA-Matic  (v1.12)
  5.                                     (c) 1987
  6.  
  7.                                  T.I.F. Software
  8.                                   a division of
  9.                               T&L Enterprises, Inc.
  10.                               3826 W. Missouri Ave.
  11.                              Phoenix, Arizona  85019
  12.  
  13.                           Author: Lloyd E. Pulley, Sr.
  14.  
  15.  
  16.  
  17.  
  18.                Disclaimer of Warranty and/or Liability
  19.                (aka..if anything goes wrong, it ain't my fault)
  20.  
  21.              Try  It First Software (hereafter known as  TIF  Software) 
  22.           makes  no warranty,  either expressed or implied,  as to  the 
  23.           usability of the enclosed programs, the documentation and any 
  24.           other related items.
  25.  
  26.              TIF  Software  will  not  be held  liable  for  direct  or 
  27.           incidental  damages resulting from any defect or omission  in 
  28.           these  programs or the documentation.   These  programs  have 
  29.           been  tested  thoroughly  but TIF Software can  not  be  held 
  30.           liable if it doesn't work on your system.
  31.  
  32.              MegaMatic has been tested to run on the 520 ST,  1040  ST, 
  33.           Mega ST2 and the Mega ST4.   It works on an all floppy system 
  34.           and on a system with hard drives.  It works on the older roms 
  35.           and  the  new ones.   It works with or  without  the  blitter 
  36.           installed.  I've even tested it on a 1040 ST that was running 
  37.           2 1/2 megs and the new roms.  But that doesn't mean it'll run 
  38.           on  your system.   Long ago I reached a conclusion that  "all 
  39.           ST's are not created equal".
  40.  
  41.              The  documentation  and programs included  in  this  arced 
  42.           file,  are copyrighted by TIF Software.   These programs  are 
  43.           NOT public domain, they are shareware.
  44.  
  45.              Since  MegaMatic is shareware,  please feel free  to  make 
  46.           copies of these programs for you,  your users groups,  BBS's, 
  47.           ect.   But  please,  make sure that you include  these  files 
  48.           everytime  you distribute it.  There is nothing that  I  hate 
  49.           worse,  than  not  getting  all the files needed  to  make  a 
  50.           program perform properly.
  51.           
  52.                MEGMATIC.PRG
  53.                CONFIG.PRG
  54.                MEGMATIC.DOC
  55.  
  56.              As I said earlier, MegaMatic is shareware.  If you like it 
  57.           and  use it,  send TIF Software a few bucks.   If  you  don't 
  58.           like, let us know why.
  59.  
  60.              Now, on to the good stuff.
  61.  
  62.  
  63.  
  64.                                     Page -1-
  65.  
  66.  
  67.  
  68.                Introduction
  69.                (or "where did I come up with this idea")
  70.  
  71.              When  I first bought my ST,  I didn't know anything  about 
  72.           the AUTO folder and how to use it.   But before too  long,  I 
  73.           had 5-6 programs in my AUTO folder that 'I just had to have'.  
  74.           Between these 5-6 programs and 3-4 accessories, it was taking 
  75.           forever to boot up my computer (even with a hard drive).   So 
  76.           to make life easier (and faster),  I decided to take the best 
  77.           ideas from each of these 'AUTO programs' and incorporate them 
  78.           into one program.
  79.  
  80.              The first problem that I ran into was that I HATE 'all-in-
  81.           one' programs.   Usually there was only 1 or 2 parts of these 
  82.           'all-in-one'  programs  that I used.   All the  rest  of  the 
  83.           program  (along with my computers memory) was wasted.   So  I 
  84.           decided  to make MegaMatic a 'all-in-one' program  where  the 
  85.           USER (that's you!) could decide what parts of it THEY  wanted 
  86.           to use.  In other words, much of MegaMatic is configurable by 
  87.           the user.   The parts that are not configurable (listed later 
  88.           in the docs) do not take up any memory after boot  up.   Once 
  89.           they do their job, they disappear from the computers memory.
  90.  
  91.              Also,  I HATE AUTO programs that 'asks questions' and then 
  92.           sits there until the user gives an input.   I want to be able 
  93.           to  turn  on my system and go do anything I want and  when  I 
  94.           come back,  it's all up and ready to go.  MegaMatic at bootup 
  95.           has  two  areas where it asks for user input (more  on  these 
  96.           later).  At each spot, MegaMatic will wait for approximately. 
  97.           1 second for an input.   If no input is  received,  MegaMatic 
  98.           will then continue on and just use the default input.
  99.  
  100.              Since I don't know C,  Pascal or Modula,  I was forced  to 
  101.           write  MegaMatic in pure 68000 assembly code (it  was  either 
  102.           that  or  GfA Basic).   MegaMatic was written  with  HiSoft's 
  103.           DevPac  Editor/Assembler.   Since  MegaMatic was  written  in 
  104.           68000  code,  you'll find it short (less than 4k)  and  fast.  
  105.           Also, once MegaMatic has been booted and is running,  it only 
  106.           takes 1k of your precious memory to run (that does not  count 
  107.           the memory needed for the ramdisk or print spooler however).
  108.  
  109.              To  make  the program user configurable,  I also  wrote  a 
  110.           CONFIG.PRG that goes along with MegaMatic.   You HAVE to  use 
  111.           the CONFIG.PRG on MegaMatic before using MegaMatic.  (more on 
  112.           CONFIG.PRG later)
  113.  
  114.  
  115.  
  116.                 How to install Mega-Matic
  117.                 (or "if you don't follow instructions, don't blame me")
  118.  
  119.              ALWAYS make a backup of all the files before attempting to 
  120.           use any of them.
  121.  
  122.              MEGMATIC.PRG  HAS to be configured with CONFIG.PRG  before 
  123.           using it.
  124.  
  125.              MEGMATIC.PRG HAS to go into the AUTO folder first.  (Sorry 
  126.           guys,  but  I  have  to know what some of  the  lower  memory 
  127.           address's  are  before some  other  program  modifies/changes 
  128.           them.)   If you are running a hard drive booter in your  AUTO 
  129.           folder, it can go in before the MEGMATIC.PRG.
  130.  
  131.                                     Page -2-
  132.  
  133.  
  134.              Mega-Matic's basic features
  135.              (or "I thought that this part would never get here")
  136.  
  137.  
  138.              1)  RESETTABLE RAM DISK **
  139.                  I've  heard the pro's and con's about  the  resettable 
  140.           ram disks.   To me, any ram disk that isn't resettable, isn't 
  141.           useable.   The resettable ram disk 'saved my bacon' more than 
  142.           once.   This ramdisk will survive a normal RESET with no loss 
  143.           of data.   But remember,  this is not guaranteed!!   99.9% of 
  144.           time  it works properly but .1% of the time the system  bombs 
  145.           beyond  repair and can corrupt the ram disk pointers  or  the 
  146.           data on the ramdisk.
  147.  
  148.                  Resettable  Ram Disks boot up a little different  than 
  149.           'normal' ram disks.   They take two 'passes' to boot up.  The 
  150.           first time MegaMatic is booted by the system,  it moves parts 
  151.           of itself into high memory (right under the graphics screen).  
  152.           It then modifies some of the lower memory pointers and does a 
  153.           warm reset which then causes it to be booted again.   It then 
  154.           looks to see if it's been booted before (by looking for  some 
  155.           'magic' data in high memory).   If it has been booted before, 
  156.           it then finishes it's job by hooking some of the lower memory 
  157.           vectors  into  the  program that has  been  moved  under  the 
  158.           graphics  screen.   At that point it returns to TOS and  lets 
  159.           the system finish booting up everything else.
  160.  
  161.                  This  ram disk is configurable in size from 128k to  2 
  162.           meg (minus 24k for 'overhead'...i.e. FAT tables, directories, 
  163.           ect.) with the CONFIG.PRG.
  164.  
  165.                  Also at powerup,  it can be temporarily configured  to 
  166.           different   sizes.    During  the  first  pass   (see   above 
  167.           paragraph), MegaMatic will display a prompt................
  168.                'Input:'
  169.           for  about  a second.   If you temporarily need  a  different 
  170.           sized ram disk from your normal one, all you have to do press 
  171.           certain  keys and the system will re-configure the  ram  disk 
  172.           size  for you.   This size will last through resets and  will 
  173.           only disappear when you power down.
  174.  
  175.           Here's  the  keys that you can press to  change  the  ramdisk 
  176.           size.   (remember,  all these sizes will be less 24k for  the 
  177.           'overhead')
  178.              1 - 128k        2 - 192k        3 - 256k        4 - 320k
  179.              5 - 384k        6 - 448k        7 - 512k        8 - 576k
  180.              9 - 640k        0 - 704k      ESC - 768k    SHIFT - 832k       
  181.  
  182.           (for you math types, just add 1 to the number and multiply by 
  183.           64)
  184.  
  185.                  The   resettable  ram  disk  is   configurable   (with 
  186.           CONFIG.PRG) as to which drive identifier that you want it set 
  187.           up as.   Your choices will be C-P.  I always use P for my ram 
  188.           disk  because  I haven't ever found anything else  that  uses 
  189.           that drive letter.   The only program that ever had  problems 
  190.           with  my  ram  disk  as drive P  was  DCopy.   He  uses  some 
  191.           nonstandard figuring and uses drive P as a printer drive.  So 
  192.           if you use DCopy,  you might not want to use P as your  drive 
  193.           indentifier.
  194.  
  195.  
  196.  
  197.                                     Page -3-
  198.  
  199.  
  200.              2)  PRINT SPOOLER **
  201.                  MegaMatic also gives you a configurable print spooler.  
  202.           This  print  spooler can be configured in size  from  16k  to 
  203.           144k.   (In  the CONFIG.PRG you just enter a value from  1-9.  
  204.           MegaMatic then figures the print spooler size by  multiplying 
  205.           16k times the figure you inputted.
  206.  
  207.                  If while printing, you want to stop the print spooler, 
  208.           just  press the CNTL/SHIFT/ALT-0 keys (the '0' is the one  on 
  209.           the keypad,  not at the top of the keyboard) all at the  same 
  210.           time.   This will zero out the print buffer.  If you've got a 
  211.           print  buffer in your printer,  this won't stop the  printing 
  212.           until your printers buffer is empty.
  213.  
  214.              3)  Disk VERIFY On/Off
  215.                  This feature allows you to turn the disk write  verify 
  216.           off or leave it on (on is the system default).   You'll  find 
  217.           your disk writes are speeded up with VERIFY off.   NOTE:   Be 
  218.           careful if you have VERIFY turned off.   Some drives can give 
  219.           bad writes if there is no VERIFY on.  You'll usually know how 
  220.           dependable your drives are.
  221.  
  222.              4)  WHICH DRIVES
  223.                  MegaMatic  will display which drives are connected  to 
  224.           the system at powerup (including ram disk).
  225.  
  226.              5)  SCREEN SAVER **
  227.                  A  screen saver will turn your screen 'off'  (turn  it 
  228.           black  on color systems,  reverse colors on mono)  if  you've 
  229.           left  your  system unattended for a certain period  of  time.  
  230.           Once you touch the mouse or a key,  the screen will return to 
  231.           normal.  This is supposedly to stop the monitors  from  being 
  232.           'burned  in'  by displaying the same screen for  hours  at  a 
  233.           time.
  234.  
  235.                  This  screen saver will work on either color  or  mono 
  236.           systems.  You  can configure (using CONFIG.PRG) how long  the 
  237.           system  will  wait before it turns the screen saver  on  (2-9 
  238.           minutes).
  239.  
  240.                  I like my screen saver to keep 'flipping'.  Going from 
  241.           off to on to off to on...etc.  I use it as a timer as well as 
  242.           a  screen saver.   When I see the screen go dark,  I  know  7 
  243.           minutes  have passed (my default) and when I see it  go  back 
  244.           normal again,  I know another 7 minutes have passed.  You can 
  245.           configure  the screen saver to 'flip' or just stay dark  with 
  246.           the CONFIG.PRG.
  247.  
  248.              6)  FREE RAM
  249.                  This  feature displays the total memory of the  system 
  250.           and how much memory is free after booting up.   This does not 
  251.           include  the memory used by accessories or other auto  folder 
  252.           programs booted up after MegaMatic.
  253.  
  254.              7)  MEMORY CHECK **
  255.                  Does a two pass memory check (a fast and a slow memory 
  256.           check), every time you boot up the system.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                     Page -4-
  264.  
  265.  
  266.              8)  AUTO DESK **
  267.                  This   feature  allows  for  the   automatic   desktop 
  268.           selection  of  either a low,  medium or high res  desktop  at 
  269.           bootup (LOWDESK.INF, MEDDESK.INF and HIGHDESK.INF).
  270.  
  271.                  MegaMatic  looks to see which monitor you're using  at 
  272.           boot up and if you're using a mono monitor,  it will boot  up 
  273.           the mono .INF file (HIGHDESK.INF).   If you're booting up  in 
  274.           color,   MegaMatic  automatically  chooses  the   MEDDESK.INF 
  275.           (medium res).   You can choose to go into low res at  powerup 
  276.           by simply pressing any key when you see the following prompts 
  277.           displayed  during MegaMatic's second pass (see  paragraph  in 
  278.           ram disk section describing the two passes)............
  279.                          'Hooking in Auto-Desktop selector'
  280.                          'Installing  '
  281.           After the word 'Installing',  MegaMatic will wait for a short 
  282.           period of time for a keypress.   If it see's it, it'll bootup 
  283.           the  LOWDESK.INF file.   If no key is pressed,  it'll  bootup 
  284.           MEDDESK.INF.
  285.  
  286.                  To create each file, you simply go to the res that you 
  287.           want,  set  the desktop up how you want it and then save  the 
  288.           desktop.  Just rename the DESKTOP.INF file to name needed (in 
  289.           low res - LOWDESK.INF,  in med res - MEDDESK.INF and in  high 
  290.           res - HIGHDESK.INF)
  291.  
  292.              9)  COLD/WARM RESET
  293.                  Once  I  got my Mega,  I found out that was  a  'major 
  294.           pain' to get to the RESET and ON/OFF switch on it (not one of 
  295.           Atari's better ideas).   And with the incompatibility of some 
  296.           programs  on the Mega,  I found myself needing the RESET  and 
  297.           ON/OFF  button more than ever.   So I added two  special  key 
  298.           combinations  that would allow me to do a warm or cold  start 
  299.           from the keyboard.  Here's the two key combinations..........
  300.  
  301.                  ALT/SHIFT/CNTL-*  (the '*' is  the one on  the  keypad 
  302.                  only) will give you a cold start (POWER OFF)
  303.                  ALT/SHIFT/CNTL-.  (the '.' is  the one on  the  keypad 
  304.                  only) will give you a warm start (RESET)
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.           ** If  you  don't  want  this  feature,   you  can  configure 
  314.           MegaMatic so that it won't be attached.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                     Page -5-
  330.  
  331.  
  332.                How to use the CONFIG.PRG
  333.                (or "aren't we done yet?")
  334.  
  335.              As stated earlier,  you HAVE to use the CONFIG.PRG  before 
  336.           using  MegaMatic.   All  the  defaults are  set  to  zero  in 
  337.           MegaMatic until CONFIG.PRG sets them.
  338.  
  339.              I didn't make CONFIG.PRG too smart,  so make sure that  it 
  340.           and  MegaMatic  are on the same directory (they can be  in  a 
  341.           folder  as  long as both programs are in  the  same  folder).  
  342.           Also,  there is minimal error trapping done.  Any errors will 
  343.           run  through  one of two routines,   either  the  READ  error 
  344.           routine or the WRITE error routine.  If you make any mistakes 
  345.           or  just  want to quit CONFIG.PRG at any time,  I  put  in  a 
  346.           'panic' key.  Just press the ESC key at any time and you will 
  347.           be sent back to the desktop without anything happening.
  348.  
  349.              When  you  double-click  on  the  CONFIG.PRG  name,  it'll 
  350.           automatically load in a file called MEGMATIC.PRG.   MegaMatic 
  351.           HAS  to  be named this or CONFIG.PRG  won't  load  it.   Then 
  352.           CONFIG.PRG  will check to make sure that the correct  version 
  353.           of MegaMatic has been loaded.   (This version is  1.1x.   The 
  354.           last  digit is not checked.   It's just there to let me  know 
  355.           which  revision you have)  Also,  you CAN configure the  same 
  356.           version  of MegaMatic over and over  again.   The  CONFIG.PRG 
  357.           automatically  sets all the defaults back to zero  when  it's 
  358.           loaded into memory.
  359.  
  360.              You'll  be asked a series of questions concerning how  you 
  361.           want MegaMatic configured.   If you've read the  descriptions 
  362.           above, the questions are all pretty much self-explanatory (if 
  363.           you haven't,  you should).   After you answer each  question, 
  364.           you'll then be prompted with a "Correct?   <Y>es  <N>o".   If 
  365.           you want to redo your answer,  just press 'N' and  CONFIG.PRG 
  366.           will take you back through the question so you can answer  it 
  367.           again.   A  'Y' will take you to the next question.   If  you 
  368.           later decide that you configured one of the earlier questions 
  369.           wrong,   don't  worry.   Before  CONFIG.PRG  will  write  the 
  370.           MEGMATIC.PRG back out to disk,  it'll ask you "Is  everything 
  371.           correct?  <Y>es <N>o".   At that point, you can press 'N' and 
  372.           you'll  start all over again.   Pressing 'Y' will  write  the 
  373.           modified  MEGMATIC.PRG back to disk and take you back to  the 
  374.           desktop.
  375.  
  376.              A special note.   Do to CONFIG.PRG's limited intelligence, 
  377.           when you are entering the size for your ram disk, you'll have 
  378.           a choice of entering 2-32 (2*64k=128k  ramdisk,  32*64k=2048k 
  379.           ramdisk).   If  you're  entering a one  digit  number  (2-9), 
  380.           you'll  have to press RETURN when done.   You don't  have  to 
  381.           press RETURN for a two digit number.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                     Page -6-
  396.  
  397.  
  398.                Final comments
  399.                (or "it looks like we're almost done!")
  400.  
  401.              MegaMatic  has  been  tested for several  months  with  no 
  402.           noticeable  bugs  but  there is no doubt  in  my  mind,  that 
  403.           someone out there is going to find one.   If they do,  let me 
  404.           know.   Tell  me  how your system is  configured,  what  AUTO 
  405.           programs you're running, what accessories that you're running 
  406.           and what happened when you had the problem.  I'll try to test 
  407.           the  problem out if possible (I don't have all  the  programs 
  408.           available for the ST though).
  409.  
  410.              The only two programs that I've had any problems with are:
  411.  
  412.              PUBLISHING PARTNER - On the Mega ST ONLY. If you have both 
  413.           the  print spooler AND the screen saver configured to be  ON, 
  414.           Publishing  Partner  will  give you garbage  on  the  screen.  
  415.           HOWEVER,  there is no problem on the 520/1040 ST's NO  MATTER 
  416.           which rom's you're using.   It has to be something to do with 
  417.           either  the  hardware in the Mega or the blitter  chip  (even 
  418.           though  I've tried it with the blitter OFF) because I had  no 
  419.           problem with a 1040 ST that was running 2 1/2 meg and the new 
  420.           roms.
  421.  
  422.              NEO-CHROME - You'll get some slight flicker at the  bottom 
  423.           of  the  screen.   They  must  be  using  some  of  the  same 
  424.           interrupts  that  MegaMatic uses and the timing  is  slightly 
  425.           off.
  426.  
  427.  
  428.              Remember,  this is Share Ware.  If you like it and use it, 
  429.           send  TIF  Software  a donation (none  too  small,  none  too 
  430.           large).   People  that  send donations will get  upgraded  to 
  431.           future  versions free.   (Future versions will NOT  be  Share 
  432.           Ware and will NOT be allowed to be freely distributed.
  433.  
  434.              Lloyd E. Pulley
  435.              MADMODIFIER - Delphi
  436.              LEPULLEY    - Genie
  437.  
  438.  
  439.                Acknowledgments
  440.                (or "without these people, it wouldn't have got done)
  441.  
  442.              I'm a converted 6809 programmer.   This was my first major 
  443.           programming test on the 68000.  Many things were very similar 
  444.           to  the 6809 and other things were radically  different  (the 
  445.           6809  don't  have  any 'cmp.b #3,#0(a1,d2)'  type  of  code).  
  446.           Also,  the  68000  is serious about  the  difference  between 
  447.           address and data registers, the 6809 isn't.
  448.  
  449.              Without  the following people's assistance,  I'd still  be 
  450.           trying to figure out how to get this program to work.
  451.  
  452.           Dan L. Moore (author of PaperClip)
  453.           Charles F. Johnson (programmer, reviewer and musician)
  454.           Mat Ratcliff (programmer and reviewer for Analog)
  455.           Dave Mumper  (author of TINYVIEW/TINYSTUFF........without his 
  456.                         help and code, I'd never got the keyboard reset 
  457.                         routine done)
  458.           and  all the others who put out fine p/d software that I  was 
  459.           able to get ideas from.
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.                                     Page -7-
  486.  
  487.